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Section 1. About this tutorial 


Should I take this tutorial? 

This tutorial is based on the "Getting started with IBM Lotus® Workplace 1.1" 
workshop, held at Solution Partnership Centers around the world. The 
workshop introduces the Lotus Workplace (LWP) environment and teaches 
attendees how to install and configure version 1.1. In this tutorial, we explore 
how you can install a stand-alone system with the IBM Lotus Workplace VI .1 
code. This environment is a good starting point to get a feel for what version 1.1 
offers; the installation can be used for a proof of concept. 

For an introduction to Lotus Workplace and its products, see "What is IBM 
Lotus Workplace? (http://www-10.lotus.com/ldd/today.nsf/lookup/LWP11)" 


About the author 


Rohit Sahasrabudhe is an e-business architect for IBM Developer Relations 
Technical Consulting in Austin, Texas. Rohit is an IBM Certified for e-business 
Solution Designer, a Solution Technologist, a Red Hat Certified Engineer, and 
an IBM Certified Application Developer - IBM WebSphere Portal for 
Multiplatforms v4.1 implementation. He holds a B.S. from the University of 
Louisville in Engineering in Math and Computer Science. He did three co-ops, 
including one in Germany, before joining IBM in 2000. He joined IBM as a 
software engineer, working on Lotus Domino solutions. Now you will find him 
helping IBM Business Partners and independent software vendors gain 
knowledge in IBM products. He travels around the world educating, enabling, 
and evangelizing. 

For technical questions about the content of this tutorial, contact Rohit 
Sahasrabudhe at sahas@us.ibm.com. 


Hardware and software requirements 

Before starting this tutorial, you should carefully check the following table for the 
minimum hardware and software requirements for a Lotus Workplace VI .1 
installation. You should also consult the related documentation in the 
Resources on page 38 section. 


Hardware requirements 

° Two Intel® Pentium® 4 or faster processors 
° 2 GB RAM minimum 
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° Virtual memory or swap space double the amount of RAM 
° At least 14 GB of free disk space 


Software requirements 

° Microsoft® Windows® 2000 Server with Service Pack 4 or higher. 

° IBM WebSphere® Application Server Enterprise Version 5.0.1. 

The Lotus Workplace 1.1 installation provides this software. Do not use a previously 
installed version of the WebSphere Application Server. 

° IBM WebSphere Portal for Multiplatforms, Version 5. 

The Lotus Workplace 1.1 installation provides this software. Do not use a previously 
installed version of WebSphere Portal. 

° IBM DB2® Universal Database Enterprise Server Edition, Version 8.1 with Fix Pack 2. Fix 
Pack 2 is provided with the software. You can use Fix Pack 3, but you must obtain this fix 
pack yourself. 

° IBM FITTP Server Version 1.3.26 (installed with the product). 

° IBM Tivoli® Directory Server Version 5.1. Other LDAP directory servers support can be 
verified by checking the updated list from the resources section. 

° Supported client operating systems: Microsoft Windows 2000, Microsoft Windows XP and 
SuSE® Linux 7.2 or later. 

° Supported browsers: 

° Microsoft Internet Explorer 5.5 with Service Pack 2 - on Windows 2000, with Microsoft 
Java Virtual Machine (JVM) 1.1. 

° Microsoft Internet Explorer 6.0 - on Windows 2000 and Windows XP with the Sun® 
plug-in version of Java Virtual Machine (JVM) 1.4.1. 

° Netscape® Mozilla 1.3 - on SuSE Linux 7.2 or later - with the Sun plug-in version of 
Java Virtual Machine (JVM) 1.4.1. 
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Section 2. Installing IBM Lotus Workplace 


Introduction 


In order to follow this tutorial for a stand-alone, "sandbox" style controlled 
environment, you may wish to set up a Loopback adapter on your system. Even 
as part of the workshops, attendees use an image created with a Loopback 
adapter. This adapter will allow you to set up a virtual network on a Windows 
environment. The underlying middleware components used in IBM Lotus 
Workplace require a fully qualified domain name. For you to follow this tutorial, 
you either need to have your own static IP address and domain name 
registered, or utilize the Loopback adapter and the HOSTS file to make the 
system think that a particular hostname and IP being used is the true IP. 

For IBM Lotus Workplace VI .1, it is recommended that you start with a clean 
Windows 2000 Server environment with Service Pack 4. The following 
instructions will help you set up a Loopback adapter on this system. 

1. Choose Start - Settings - Control Panel - Add/Remove Hardware. 

2. Click Next. 

3. Select Add/Troubleshoot a device and click Next. 

4. Select Add new device and click Next. 

5. Select No, I want to select the hardware from a list and click Next. 

6. Scroll down and select Network adapters as the hardware type and click 
Next. 

7. Scroll down and select Microsoft as the manufacturer and Microsoft 
Loopback Adapter as the network adapter and click Next. 

8. Click Next and click Finish. 

9. From the Windows desktop, right-click on My Computer, select Properties. 
10.Select the Network Identification tab, then click the Properties button. 

11 .Click More and add the suffix: techpreview.ibm.com in the text box. 
Check the box underneath (change primary DNS suffix) as selected. 

12.Click OK all the way through and you will probably be asked to reboot. 

Once you've rebooted, set your IP address as follows: 

1. Choose Start - Settings - Network and Dial up Connections. 

2. Right-click the Microsoft Loopback Adapter. 

3. Click Properties. 

4. Scroll down and double-click Internet Protocol (TCP/IP). 

5. Enter an IP address (10.0.0 . l) and Subnet Mask (255.0.0.1). 

6. Reboot. 

Add this fully qualified hostname (assumed by this tutorial: 

lwpi l . techpreview . ibm . com the IP address (l 0.0.0 . l) to your 
c :\wi n nt\syste m 32\d ri ve rs\etc\hosts file. 


Page 4 of 38 


Installing IBM Lotus Workplace 1.1 



Lotus software 


http://www-136.ibm.com/developerworks/lotus/ 


Check your network settings. Start a command line window, and execute the 
command: 

ping lwpll.techpreview.ibm.com 

The IP address should be 10.0.0.1 instead of 127.0.0.1. 

The tutorial assumes that the DB2 Administrator and the Windows Administrator 
user is the following: 

Userid: db2admin 

Password: db81admn 

Installation tips: Be patient. Some of the scripts take time to 
execute. And keep the Task Manager in view to get a clear 
picture of the installation process. 


Installing IBM DB2 UDB 8.1 Enterprise Server 

1. Create a local db2admin account, and assign it a password (this tutorial 
assumes: dbSiadmn) if one doesn't already exist and make this account a 
member of the Administrators group. 

2. If you haven't already, log in as db2admin and make sure you have the 
following Local Security Policies set for your db2admin user. 

Assign these policies by choosing Start - Programs - Administrative Tools - 
Local Security Policy , Select Local Policies - User Rights Assignments: 

° Act as part of the operating system 
° Create a token object 
° Log on as a service 
° Replace a process level token 

3. Verify that the db2admin account is a member of the local Administrators 
group. If not, add the user in that group. 

4. From the DB2 Enterprise Edition CD (CD 5-1), run either Setup.exe or 
Launchp.exe. 

5. On the installer screen, click Install Products. 

6. Click Next (DB2 UDB Enterprise Server Edition is selected). 

7. From Welcome to the DB2 Setup Wizard, click Next. 

8. Review the license agreement. If you accept the terms, click I accept the 
terms of the agreement and click Next. 

9. In the Setup the installation type window, click Typical and click Next. 

10. The default screen does not have Data Warehousing and Satellite 
administration capability selected. Do not change the defaults. Click Next. 
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11 .A warning screen appears regarding APPC. Click OK. 

12. At Select the installation action, accept the default, Install DB2, Enterprise 
Server Edition on this computer. Do not select Save your settings in a 
response file. Click Next. 

13. At Select installation folder for DB2, select the installation folder. This tutorial 
assumes the folder to be C:\SQLLIB. 

14.Set user information for the DB2 Administration Server as follows, and click 
Next when you are done: 

° For user name, enter db2admin, and be sure all the rights are selected 
for this user. 

° Specify the password created in step 1. 

° Leave Use the same user name and password for the remaining DB2 
services checked. 

15. At Set up the administration contact list, accept the default, (Local) and click 
Next. 

16. When you see a warning screen, Notification SMTP server, click OK. 

17.In the Configure DB2 instances screen, click Protocols and configure the 
TCP/IP protocol. Keep the default settings (Service name, db2c_DB2 and 
Port number, 50000), click OK, then Next. 

18. In the Prepare the DB2 tools catalog window, click Prepare the DB2 tool 
catalog in a local database and click Next. 

19. In the Specify a local database to store the DB2 tools catalog window, 
accept the defaults and click Next. 

20. In the Specify a contact for health monitor notification window, click Defer 
the task after installation is complete and click Next. 

21 .In the Start copying files window, review the list and click Install. 

22. Click Finish when installation completes. 

23. Reboot the machine, then follow the instructions to Apply DB2 UDB 8.1 Fix 
Pack 2. 


Apply DB2 UDB 8.1 Fix Pack 2 

You must apply at least Fix Pack 2 to DB2 UDB 8.1 

1. Log on as db2admin. 

2. Go to Control Panel/Services and stop all the DB2 services (that are started 
automatically), except for DB2 DB2-0. 

3. From the DB2 Fix Pack 2 CD (CD 5-10), run update.exe. It will automatically 
find the previous installation of DB2 8.1. If prompted to stop DB2 services, 
click YES. 

4. Click OK, and UPDATE when prompted. Wait until this process is complete. 

5. If you see a screen stating DB2 is currently running and locked by the 
following processes, click YES to shutdown those processes and continue. 

6. Click Finish at completion. 
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7. Reboot your machine. 

Next, you'll need to install IBM Directory Server 5.1. 


Installing the IBM Directory Server 5.1 

Probably the most important component of a successful LWP deployment is the 
LDAP server schema. It is imperative that the LWP administrator collaborate 
with the LDAP administrator. This tutorial assumes a clean install of IBM 
Directory Server 5.1 and import of provided LDIF. If you are using an existing 
LDAP server, you can skip the instructions below and go to Lotus Workplace 
installation on page9 . 

Follow these steps to install IBM Directory Server 5.1 on the same system as 
Lotus Workplace. 

1. Log on to the local system as db2admin. 

2. From the IBM Directory Server 5.1 CD (CD 3-1), change to the idsjsmp 
directory and run Setup.exe. 

3. Select English as the language to be used and click OK. 

4. Click Next on the Welcome to Instailshield Wizard. 

5. Review the license agreement. If you accept, accept the terms in the license 
agreement and click Next. 

6. Click Next at the verification that DB2 is already installed. 

7. Change the directory name to c : \ldap and click Next. 

8. Select English as the language for IBM Directory Server and click Next. 

9. It is critical to select CUSTOM as the setup type and click Next. 

10. Because IBM Directory Server 5.1 uses WebSphere Application Server to 
deploy the graphical administration client, you must uncheck Web 
Administration and IBM WebSphere Application Server. Therefore, only 
select Client SDK, Server 5.1 and GSKit. Then click Next. 



Select the features to install 

Client SDK 51 (7M) 

Web Administration 5.1 (24M) 

Server 5.1 (67M) 

IBM WebSphere Application Server - Express 5 0 (114M) 
DB2V81 (381M) 

GSKit (11M) 


installShield 


«Back | Next» 


^Ifijxj 


Cancel 
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11. Review the installation summary and click Next. 

12. Click OK to begin GSKit installation. 

13. Click Next (possibly twice) at the completion of installation. 

14. Click Next to restart your server. 

15. Click Finish. 

16. Reboot your system. 


IBM Directory Server 5.1 Configuration 

Upon reboot, there are a few configuration steps required using the IBM 
Directory Server Configuration Tool. 

° Click Administrator/DN password. 

1. For the Administrator DN, use the default, cn=root. 

2. For the Administrator password, use password. 

3. Confirm password, use password. 

4. Click OK. 

5. Click OK. 

° Click Configure Database. 

1. Check Create New Database and click Next. 

2. Enter your DB2 Administrator user ID, db2admin. 

3. Enter the DB2 Administrator password, dbSiadmn. 

4. Click Next. 

5. Enter a database name, db2idap, and click Next. 

6. Check Create a universal DB2 database (UTF-8/UCS-2) and click Next. 

7. Use drive C for the database location and click Next. 

8. Verify the settings and click Finish. 

9. Upon completion, click Close. 

° Click Configure Suffixes. 

1. Under Suffix DN enter: dc=ibm, dc=com and click Add. 

2. Click OK. 

° Click Import LDIF File. 

1. Click Browse and navigate to select the sample LDIF file, provided in 
Resources on page38 . 

2. Choose Standard Import. 

3. At the bottom of the page, click Import. 

4. Upon completion, click Close. 

° Close IBM Directory Server Configuration by choosing File - Close. 

Now start IBM Directory Server via Windows Services IBM Directory Server 5.1. 
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Lotus Workplace installation 

1. Make sure you are logged in to Windows as db2admin. 

2. Run install.bat from the Lotus Workplace Setup CD. 

3. In the Select a language to be used for this wizard window, select English 
and click OK. 

4. In the IBM Lotus Workplace Installer window, click Install. 

5. In the Welcome to the IBM Lotus Workplace Installation program window, 
click Next. 

6. In the Results of system check... window, make sure you see A supported 
IBM DB2 Enterprise Server is installed on your server. Click Next. 

7. In the The system check detected a DB2 Enterprise Server on this computer 
window, select the option This computer will host Lotus Workplace data and 
products, then click Next. 

8. In the Before continuing Lotus Workplace installation, WebSphere Portal 
must be installed window, click Next. You will see the screen Installing 
WebSphere Portal. Do not close this window. You can't click on this installer. 

9. The Lotus Workplace Version 1.1 Installer opens to install Portal. In the 
Select a language to be used for this wizard window, choose English (the 
default) and click OK. 

10. In the Welcome to the Installshield Wizard window, click Next. 

11. Review the license agreement. If you accept the terms, click I accept the 
terms, then click Next. If you see a box asking you to disable any firewall 
products running on this machine prior to installation, click OK after disabling 
them manually. 

12. In the Choose the setup type that best suits your needs window, select Full 
and click Next. 

13. In the WebSphere Application Server will be installed in the following 
directory window, accept the default, C:\WebSphere\AppServer and click 
Next. Make sure this directory path contains no spaces. 

14. In the IBM HTTP Server will be installed in the following directory window, 
accept the default, C:\IBMHttpServer and click Next. 

15. In the You can use Windows Services to run the following WebSphere 
Application Server features window, just select the Run IBM HTTP Server as 
a service option. Enter your Windows administrator username (db2admin) 
and password (dbSiadmn), and click Next. 

16. In the Enter a node name for this instance of WebSphere Application Server 
window and in the Enter the hostname for this installation of WebSphere 
Application Server window, enter a node name (lwpii), and enter the fully 
qualified host name (lwpil. techpreview. ibm. com) then click Next. 

17. In the WebSphere Portal will be installed in the following directory window, 
accept the default C:\WebSphere\PortalServer, then click Next. 

18. In the Enter the Portal administrative user and password window, enter 
wpsadmin for the Portal administrator username and wpsadmin for the 
password, confirm the password, and then click Next. 

19. In the window Lotus Workplace is ready to install. The following components 
will be installed, click Next. You will see multiple screens as installation 
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progresses. Installation takes approximately one hour. You will use CD1-1, 
CD1 -6, and CD2 for this part of the installation. (This tutorial assumes Portal 
Administrator of wpsadmin with password of wpsadmin.) 

20. In the Installation is successful window, which lists all the components that 
have been installed, uncheck Launch First Steps and click Finish to launch 
the Lotus Workplace Installer. 

21 .In the Results of system check window, click Next. 

22.Make sure that the prerequisite product installation has been completed: 

° Windows 2000 Server with Service Pack 4 

° WebSphere Portal Server V5.0 
° DB2V8.1.2 


Lotus Workplace Products installation 

1. In the Click Next to install Lotus Workplace Products window, click Next. You 
will use the Workplace CD for this part of the installation. 

2. In the IBM Lotus Workplace Installation window, click Next. 

3. In the Select the Lotus Workplace products that you have purchased 
licenses for window, select all the products then click Next, as shown in the 
following figure: 


0IBM Lotus Workplace Installation Program 


Select the Lotus Workplace products that you have purchased licenses for. 

F Lotus Workplace Messaging 
F Lotus Workplace Team Collaboration 
F Lotus Work p lace Conaborattve L eamin g 

Lotus Workplace Web Content Management (LWWCM) 

Noteifyou have purchased licenses for LWWCM. insert the CO labeled 
IBM Workplace Web Content Management to begin the install process 
upon completion of the automated install 

By accepting the terms of the license agreement on the next screen you 
acknowledge that you are licensed for the above selected Lotus Workplace 
products 

stallShield- 


Lotus, software 



■ ■ 

• *«••••• 
•«••••• 
^ ••••• 


IBM. 


<Back Next* Cancel 


4. Review the license agreement. If you accept the terms, click I accept the 
terms and click Next. 
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5. At the next screen which describes the install options, select Install and set 
configuration properties and click Next, as shown in the following figure: 


IBM Lotus Workplace Installation Program 


Choose one of the following installation types. Setting configuration properties 
In the Installation program does not configure Lotus workplace. Alter the 
Installation program finishes you must configure Lotus Workplace See the IBM 
Lotus Workplace 1.1 Installation Guide for information on configunng Lotus 
workplace. 

(• Install and set configuration properties 
Choose this option to install and set configuration properties 
Set configuration properties only 

Choose this option to set new configuration properties for an existing Lotus 
Workplace Installation. If the installed Lotus Workplace was previously 
configured, the new configuration properties that you provide will overwrite any 
existing configuration properties 

f' Install only 

Choose this option to install Lotus Workplace without setting configuration 
properties 


Lotus, software 


M 




IBM. 


stallShn 


< Back Next» Cancel 


6. In the Click Next to install IBM Lotus Workplace to this directory window, 
accept the default C:\WebSphere\WorkplaceServer and click Next. 

7. In the window The following WebSphere Application Servers were found on 
this computer, the system should display C:\WebSphere\AppServer. Click 
Next. 

8. In the Based on the products you selected on the previous panel, these 
features are available for configuration window, leave all the defaults 
selected, then click Next, as shown in the following figure: 
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Granting access 

1. In the window Lotus Workplace will install a WebSphere Application Server 
on this computer. Lotus Workplace requires administrator access to this 
server, enter wpsbind as the administrator name and password as the 
password, then click Next, as shown in the following figure: 
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) IBM Lotus Workplace Installation Program 


aJZj2<J 



Lotus Workplace requires administrator access to this server Provide a user 
name and password for a WebSphere administrator 

EnterWebsphere administrator name 

|wpsbind 

EnterWebsphere administrator password 


Confirm password 


istallShii 


« Back 


Next* 


Cancel 


2. In the window Lotus Workplace will install a WebSphere Portal on this 
computer. Lotus Workplace requires administrator access WebSphere 
Portal, enter wpsadmin as the administrator name and wpsadmin as the 
password, then click Next, as shown in the following figure: 


IBM Lotus Workplace Installation Program 


*J 


Lotus, software 



m 


IBM. 


stallShie 


Lotus Workplace requires administrator access to WebSphere Portal. 
Provide a user name and password for a WebSphere Portal administrator 

Websphere Portal administrator user name 

fivpsadmin 

Websphere Portal administrator password 


Confirm password 


€>•••• 


« Back 


Next* 


Cancel 
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3. In the To create its databases, Lotus Workplace requires window, enter the 
local DB2 program directory, c : \sqllib, then enter db2admin for the DB2 
administrator name, and dbSiadmn as the password. Click Next. 

4. In the window Lotus Workplace sends failure notifications and other 
automatically generated administrative messages from a postmaster 
account, enter the mail service queue directory as c : \qf ilestore, and a 
valid e-mail address for the postmaster account. Click Next, as shown in the 
following figure: 



Learning Management Server settings 


1. In the Learning Management Server Settings window, enter 

http : / /lwpl 1 . techpreview . ibm. com, and enter ldsadmin as the 

username and password as the password, as shown in the following figure. 
The username does not have to exist in a directory. 
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2. In the Additional Learning Management Server Settings window, do the 
following (see also the figure below) and then click Next: 

° For Learning Management Server administrator LDAP user or group 
name, enter wpsadmin. 

° For Learning Management Server administrator name type, keep the 
default selection, User. 

° For Path for Learning Management Server application log files, enter 

c:\lms_logs. 

° For Path for imported course packages, enter c: \ims_packages. 
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IBM Lotus Workplace Installation Program 
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Additional Learning Seiver Settings 



Learning Seiver administrator LDAP user or group name (for example. 
Imsadmin or LMSAdmins/Group/acme) 

[ivpsadmin 

Learning Server administrator name type 
[user 3 


IK! «* 

• «!••••• 
| * »•••• 


IBM. 


Patti for Learning Server application log files 


|c Alms Jogs 

Path for imported course packages 

Browse 

|c\lms packages| 


Browse 


sta 


ihii 


« Back Next > 


Cancel 


3. At the second Additional Learning Management Server Settings screen, 
enter c: \ juruindex for the Juru index path and English for the Juru 
index language. Click Next, as shown in the following figure: 


©IBM Lotus Workplace Installation Program 


Additional Learning Server Settings 

Juru is a full-text search capability that allows extended searches of 
document collections Specify a path for the location where the Learning 
Server will store Juru Index files, and specify the language that you expect the 
indexed content to use. 

Juru index path 
|c:\jurulndex 

Browse 

Juru index language 
[English 3 


Lotus, software 


F 


IBM. 


«Back Next* Cancel 
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Learning Delivery Server settings 

1. In the Learning Delivery Server Settings window, enter 

http : / /lwpl 1. techpreview . ibm. com, ldsadmin as the username, 
and password as the password. The delivery server will use this information 
to authenticate with the Learning Management Server (see also the figure 
below). The username does not have to exist in a directory. Click Next. 



2. In the Additional Learning Delivery Server Settings window, enter the 
following (see also the figure below) and click Next: 

° For Server ID, enter dsi for the Learning Delivery Server. 

° For Description, enter Learning Delivery Server 1. 

° For Path for Learning Delivery Server application log files, enter 

c:\lms_logs 
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3. At the second Additional Learning Delivery Server Settings window, enter 
the following (see also the figure below) and click Next: 

1. For E-mail address to receive system notifications sent by the Learning 
Delivery Server, enter a valid e-mail address for the administrator, 

wpsadmin@lwpl1.techpreview.ibm.com. 

2. For E-mail address from which Learning Delivery Server system 
notifications are sent, enter an e-mail address to display for Learning 
Delivery Server notifications, 

wpsadmin@lwpll .techpreview. ibm. com, as shown in the following 
figure: 
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Learning Delivery Server Content Deployment 
Settings 

1. In the Learning Delivery Server Content Deployment Settings window, enter 

http: / /lwpi l. techpreview. ibm. com, and click New to specify a 
server to provide course content, as shown in the following figure: 
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2. In the Learning Delivery Server Content Server Settings window, enter the 
following (see also the figure below), then click Next: 

° For Server name, in the Content Deployment Settings panel, enter a 
name to identify this Content server, Lwpii. 

° For the Deployment type, select File system. 

° For Location for deployed content, enter 

C : \IBMHttpServer\htdocs\en_US\content and click OK. 
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Learning Delivery Server Content Server Settings 

Select a server name to Identify this content server on the Content Deployment 
settings panel, and select the method that the Learning Server should use to 
deploy content to this content server (FTP or direct file system copy) 

Server name _ Deployment type 

|Lwp11 |Filesystem -I 

Location for deployed content __ 

|cHBMHttpServerthtdocsten_US\content| 

Type the file path that the Learning Server will use to access the content server, 
not the content servers local file path 


OK | Cancel | 


Shield 


Cancel 


3. Click Next with the Learning Delivery Deployment Settings defined, as 
shown in the following figure: 


IBM Lotus Workplace Installation Program 
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Learning Delivery Server Content Deployment Settings 

This panel collects configuration Information for one or more content servers 
used by this Learning Delivery Server to provide course content If you 
configure more than one content server, they all must be accessed using the 
same content URL 

Content URL _ 

|http://lwp11 techpreview.lbm.com 


Use the New, Edit, or Delete buttons to add or remove content servers, orto 
modify a content servers settings 


New | Edit | Delete 

Lwpll 


field 


«Back | Next» | Cancel 
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Lotus Workplace Learning settings 

1. In the Lotus Workplace Learning Settings window, enter 

http: / /lwpi l. techpreview. ibm. com as the URL for the Learning 
Management Server and click Next, as shown in the following figure: 


IBM Lotus Workplace Installation Program 




Lotus, software 



Lotus Workplace Collaborative Learning Settings 


Learning Server URL (Example http //lms ibm com) 
^ttp//lwpi 1 techpreview ibm,com 


tiield 


< gack | Next» | Cancel 


2. In the window Lotus Workplace can create a single database for all installed 
products, or separate ..., select Create multiple databases, and click Next, 
as shown in the following figure: 
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3. In the window To create its databases, Lotus Workplace requires the 
location of the DB2 databases, specify the following (see also the figure 
below) and then click Next: 

° For DB2 program directory, enter c : \sqllib, which should be the 
default selection. 

° For DB2 administrator name, enter db2admin. 

° For DB2 administration password, enter dbSiadmn. 
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0IBM Lotus Workplace Installation Program 


ill 


Lotus, software 



• •••• 
• •••• 




IBM. 


To create Its databases. Lotus Workplace requires the location of the DB2 
databases on this server and the name and password of a DB2 
administrator who has the right to create databases and schemas 

DB2 program directory 
|C:\SQLUB\ 

Browse 

D82 administrator name 
|db2admin 


D82 administrator password 


Confirm password 


sta 


ihii 


« Back 


Next* 


Cancel 


4. At the Warning, to create new database screen, click Next and answer Yes 
to the subsequent warning specifying data will be lost. 

5. In the DB2 data directory, specify the DB2 data directory window, accept the 
defaults: C:\lwpdata and C:\db2backups as the directory to hold the backup 
files, as shown in the following figure. Click Next and wait. This step may 
take a minute to complete. Do not click Next again. 
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) IBM Lotus Workplace Installation Program 




Type the path to the DB2 data directory on this computer where the 
installation program will create new Lotus Workplace databases. 

jctlwpdata 

Type the path to the directory where you want to back up these 
databases 

Browse 

new 

|C:tdb2backups 


Browse 





•M • •••• 



stallShu 


< Back Next» 


Cancel 


Summary and installation wrap up 

1. In the Summary information window, click Next and wait. This step may take 
a minute to complete. Do not click Next again. 
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) IBM Lotus Workplace Installation Program 




Lotus, software 


Summary information The following Lotus Workplace features will be installed 
on this computer 




• •••• 
• •••• 
• •••• 
• •••• 
• •••• 



*POP 3 
'IMAP 

'Mail Service 

*Web Conferencing 

'Learning Server 

'Learning Delivery Server 

'Learning Portlets 

'Instant Messaging and Presence 

Team Space 


stallShu 


« Back Next > 


Cancel 


2. In the Please read the information below window, click Finish and click Exit 
on the IBM Lotus Workplace Installer screen, as shown in the following 
figure: 


0-IBM lotus Workplace Installation Program 


*J 


Lotus, software 



■ 

X 


IBM. 


stallShie 


Please read the information below 

Click Finish to complete the installation After the installation completes, 
perform these additional tasks to configure Lotus Workplace on this computer 

1. Open the Lotus Workplace properties file. Iwpprops properties, and confirm 
that each property in the file is set to a value appropnate for your environment 

2. Based on the intended role of this computer in the Lotus workplace 
deployment, run one of the available configuration commands For information 
on running configuration commands, seethe IBM Lotus Workplace 1 1 
Installation Guide on the Web at 

htto /fwww lotus com/ldd/notesua nsf/findflwpl t 


Finish 
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3. Do not start Lotus Workplace yet. First, configure Lotus Workplace, as 
described in the next section. 
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Section 3. Configuring IBM Lotus Workplace 


Create local databases 

After you have installed the WebSphere Application Server, WebSphere Portal 
Server, and Lotus Workplace products, follow these steps to configure the 
software. We will be capturing the output in a log file to help debug any 
problems that occur. 

1. To create the necessary local databases: 

° Log on to your Windows system as db2admin. 

° Ensure the default application server, serverl, is started: 

1. C:\websphere\appserver\bin\serverstatus all. (Do not be 

concerned that WebSphere_Portal or LotusWorkplace_Server are not 
listed as application servers. They will be added in a subsequent 
steps.) 

2. If serverl is not running, start it: 

c:\websphere\appserver\bin\startserver serverl 

2. At the DOS prompt, go to C :\ WebSphere\WorkplaceServer\config 

and enter the following command, as shown in the figure below: 

° LwpDBconfig lwp-create-db > createdb . log (processing takes 
about 20 minutes). 



° Verify that you see BUILD SUCCESSFUL in the log file indicating that the 
databases are created. 

3. Verify the list of DB2 databases, as shown in the figures below: 

° At the command prompt type: 


db2cmd 
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db2 list database directory 
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Configure Lotus Workplace servers 

1. At the DOS prompt, go to 

C:\WebSphere\WorkplaceServer\config\lwpprops.properties 

and edit/configure the following property: 

° LWPHostName is set to Iwpl 1 .techpreview.ibm.com, as shown in the 
figure below: 



° PortalSafeMode is set to False, as shown in the figure below: 



2. Go to C : \WebSphere\WorkplaceServer\conf ig and enter the 
following command, as shown in the figure below: 

° lwpconfig lwp-base-setup - basesetup . log (this process 
takes about 90 minutes) 



° Verify that you see BUILD SUCCESSFUL in the log file indicating that the 
base-setup is complete. 

3. Enter the following URL in your browser to verify that all servers are running: 

http://lwpl1.techpreview.ibm.com:9081/lwp/workplace 

You should see a plain login screen. Do not log in to the Workplace yet. 
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Update the Web server plug-in file 

1. Enter the following URL in your browser: 

http://lwpl1.techpreview.ibm.com:90 91/admin 


2. Log in as any user name. The name is not verified, as we don't have security 
enabled yet. 


WebSphercg Application Server Admlnlslrellre Console 

Version 5 



Us* D 




The User O does not requve a password, and does not need to be a User O ol 
a user n the toed user registry I is oofy used to track user-specific changes to 
configuration data Securty is NOT enabled 


I O* I 


Zl 


3. Select Environment - Update web server plug-in. 
Click OK to update. 
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Enable security 

1. Make sure the following entries exist in the LDAP directory. Create them if 
necessary before continuing to the next step. 

° A user entry for the WebSphere administrator. The entry must have write 
access to the directory. The tutorial set up assumes it to be wpsadmin or 
uid=wpsadmin, cn=users, dc=ibm, dc=com as found in the LDAP. 

° A user entry for the WebSphere Portal administrator. The entry must 
have write access to the directory. Do not create a separate entry. 

Instead use the entry for the WebSphere administrator. 

° A user entry for the LDAP administrator. The entry must have write 
access to the directory. Do not create a separate entry. Instead use the 
entry for the WebSphere administrator 

° Note: You can use one entry to represent the WebSphere administrator, 
WebSphere Portal administrator, and LDAP administrators, rather than a 
separate entry for each. This tutorial assumes one entry to represent all 
three administrators 

° A user entry with read access or greater used for WebSphere Portal 
searches of the directory. This entry can be the same one used for the 
LDAP administrator. The tutorial set up assumes it to be wpsbind or 
uid=wpsbind, cn=users, dc=ibm, dc=com as found in the LDAP. 

° A Portal administrator group entry with write access to the directory. This 
group must include the WebSphere administrator, Portal administrator, 
and LDAP administrator names. The tutorial set up assumes it to be: 

wpsadmins or uid=wpsadmins, cn=groups, dc=ibm, dc=com as 

found in the LDAP. 

2. At the DOS prompt, go to c: \webSphere\AppServer\bin and enter the 
following command to create a backup configuration: 

° backupconfig.bat 

3. Go to c : \webSphere\AppServer\bin and enter the following command 
to restart the server (see also the following figure): 

° serverStatus -all 
° startServer serverl 
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lOJx] 

■B 


ADMU5002I: 1.223 files successfully backed up 

C:M/cbSphcre\Ai)pSe»'vei 4 \bin>serverstatus -all 
rtDMU011f>I : Tool infornation is being logged in file 

C:\WebSphere\AppServer\logs\serverStatus.log 
ADMU0500I : Retrieving server status for all servers 
ADMU0S0SI: Servers found in configuration: 

ADMU0506I: Server nane: LotusUorkplace^Server 
ADMU0506I: Server nane: serverl 
ADMU0506I: Server nane: WebSpbcre_Portal 

ADF1U0509I: The Application Server "LotusWorkplace_Server" cannot be reached. It 
appears to be stopped. 

ADMU0S09I: The Application Server "serverl" cannot be reached. It appears to be 
stopped. 

ADMU0509I: The Application Server ''WebSphere^ortal*' cannot be reached. It 
appears to be stopped. 

C:\WebSphere\AppServer\bin>startserver serverl 
ADMU0116I: Tool infornation is being logged in file 

C:\WebS phe re\AppServer\logs\serverl\.s tart Server, log 
ADMU3100I: Reading configuration for server: serverl 
ADMU32001: Server launched. Waiting for initialization status. 

ADI1U3000I : Server serverl open for e-business; process id is 2140 

Cs\tfebSphere\AppServer\bin> 



4. Note: Included in the Resources on page 38, you will find a completed 
Iwpprops.properties.techpreview file. You can copy it to 
c:\websphere\workplace\config and rename it to Iwpprops.properties or use 
it as a working template. 

5. Go to C : \WebSphere\WorkplaceServer\config 

° Edit Iwpprops.properties and specify the following LDAP server 


properties, all of which are required: 


Property 

Description 

Wps.LDAPWasllserid=<DN> 

Fully distinguished name that 
corresponds to the WebSphere 
administrator entry in the LDAP 
directory. This name must have write 
access to the directory. This tutorial 
assumes 

uid=wpsadmin,cn=users,dc=ibm,c 

WasAdmin=<non-qualified name> 

The non-qualified name of the 
WebSphere administrator entry. This 
tutorial assumes wpsadmin. 

WasPassword=<password> 

Password for the WebSphere 
administrator entry. This tutorial 
assumes wpsadmin. 

Wps.PortalAdminldLong<DN> 

Fully distinguished name that 
corresponds to the Portal administrator 
entry in the LDAP directory. This name 
must have write access. The name can 
be the same as the one used for the 
WebSphere administrator. This tutorial 
assumes 

uid=wpsadmin,cn=users,dc=ibm,c 

PortaIAdminld=<non-qualified name> 

Non-qualified name of the Portal 
administrator entry. This tutorial 

Installing IBM Lotus Workplace 1.1 
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assumes wpsadmin. 

PortalAdminPwd=<password> 

Password for the Portal administrator. 
This tutorial assumes wpsadmin. 

Wps.LDAPAdminUld=<DN> 

Fully distinguished name that 
corresponds to the LDAP administrator 
entry in the LDAP directory. The name 
must have write access to the 
directory. The name can be the same 
as the one for the WebSphere 
administrator or Portal administrator. 

This tutorial assumes cn=root. 

Wps. LDAPAdmi n Pwd=<password> 

Password for the LDAP administrator. 
This tutorial assumes password. 

Wps.LDAPBindlD=<DN> 

Fully distinguished name that Portal 
uses when searching the directory. 

The name requires only read access to 
the directory. Can be the same as the 
LDAP administrator name. This tutorial 
assumes 

uid=wpsbind,cn=users,dc=ibm, do 

Wps.LDAPBindPassword=<password> 

Password for the name used for 
searches. This tutorial assumes 

password. 

Wps.PortalAdminGroupld=<DN> 

Fully distinguished name of the Portal 
administrator group entry in the LDAP 
directory. The group must have write 
access to the directory and include as 
members the WebSphere 
administrator, Portal administrator, and 
LDAP administrator names. This 
tutorial assumes 

cn=wpsadmins,cn=groups,dc=ibm, 

Wps.PortalAdminGroupldShort=<non-qi 

name> 

jalified Non-qualified name of the WebSphere 
Portal administrator group. This tutorial 
assumes wpsadmins. 

WpsHostName=<hostname> 

Fully qualified host name of the Portal 
server, for our set up: 

lwpl1.techpreview.ibm.com. 

Wps.SSOEnabled=<true or false> 

True to use single sign-on (SSO) with 
Lotus Workplace products, false 
otherwise. SSO is configured through 
WebSphere Portal. Enter true. 

Wps.SSODomainName=<SSO 

domain> 

If using SSO, SSO domain of the 

Portal server, for example, .acme.com. 
This tutorial assumes: 

.techpreview.ibm.com. 

Note: There is a leading before the 


Page 34 of 38 


Installing IBM Lotus Workplace 1.1 



Lotus software 


http://www-136.ibm.com/developerworks/lotus/ 



SSO domain name. 

Wps.LDAPHostName=<LDAP host 
name> 

Fully qualified name of the LDAP 
server, 

lwpl1.techpreview.ibm.com. 

Wps.LDAPType=<type of LDAP 
directory server> 

Type of LDAP directory. This tutorial 
assumes ibm_directory_server 

Wps.LDAPSSLEnabled=<true/false> 

True to use SSL for connections to the 
LDAP directory server, or false 
otherwise. Enter false. 

Wps.LDAPSuffix=<suffix> 

Suffix for the LDAP directory server. 

This tutorial assumes 

dc=ibm, dc=com. 

Wps.LookAside=<true/false> 

True to use WebSphere Portal 

Member Manager (recommended), 
false otherwise. Enter true. 

LWMLocalDomainNames 

The domains that will be considered 
local for receiving mail. Only users with 
addresses that match this will be able 
to use Workplace Messaging. This 
tutorial assumes 

techpreview.ibm.com. 

LWMFullyQualifiedDomainName 

Your full DNS server name. This 
tutorial assumes 

lwpl1.techpreview.ibm.com. 

LWMDnsNames 

A DNS local to you. On a stand-alone 
system, you may need to specify a 
dummy name. This tutorial assumes 

lwpl1.techpreview.ibm.com. 


° Go to C : \WebSphere\WorkplaceServer\conf ig and enter the 
following command (see also the figure below): 

lwpconfig lwp-enable-ldap-security > 
enableSecurity.log 

Note: Ensure the LDAP server is started and you have connectivity if it is 
installed on a remote server. 


J£]xJ 


C:\lJebSphere\lJorkplAceSeruer\conf ig>lwpconf ig lwp-enable-ldap-security > enables 
ecurity.log 

C:\WcbSphere\V/orkplaceScrver\conf ig>notepad enablesecurity. log 


° Go to c : \webSphere\AppServer\bin and enter the following 
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commands (see also the figure below): 

° serverStatus all -username wpsadmin -password 
wpsadmin 


° Depending on which application servers are running, stop them in the 

following order: 

1. stopServer LotusWorkplace_Server -username 
wpsadmin -password wpsadmin 

2. stopServer WebSphere_Portal -username wpsadmin 
-password wpsadmin 

3. stopServer serverl -username wpsadmin -password 
wpsadmin 

° Now start the application servers, in the following order: 

1. startServer serverl 

2. startServer WebSphere_Portal 

3. startServer LotusWorkplace_Server 




C:\WebSphere\AppServer\bin>serverstatus -all -usernane wpsadnin -password wpsadnS 


ADMU0U6I: 


ADMU0500I 
ADMU0SWbI 
ADMU0506I 
ADMU0S06I 
A DMU 01 > 0 f> I 
ADMU0509I 


ADMU0509I: 
ADMU 0 S 08 I: 


Tool infornation is being logged in file 
C:\WebSphere\AppServer\logs\serverStatus.log 
Retrieving server status for all servers 
Servers found in configuration: 

Server nane: LotusWorkplace.Server 

Server nane: serverl 

Server nane: WebSphere.Portal 

The Application Server "LotusWorkplacc.Server" cannot be reached. It 
appears to be stopped. 

The Application Server "serverl" cannot be reached. It appears to be 
stopped. 

The Application Server "WebSphcre_Portal" is STARTED 


C:sWebSphere\AppServer\bin>stopserver WebSphere.Portal -usernane wpsadnin -passw| 
ord wpsadnin 

ADMU0116I: Tool infornation is being logged in file 

C:\WebSphcre\AppServer\logs\WebSphere_Portal\stopServer.log 
ADHU3100I: Reading configuration for server: WebSphere_Portal 
ADMU3201I: Server stop request issued. Waiting for stop status. 

ADMU4000I: Server WebSphere.Portal stop conpleted. 


C:\WebSphere\AppServer\bin>startserver serverl 
|ADHU0116I: Tool infornation is being logged in file 

C:\WebSphere\AppServcr\logs\serverl\startServer.log 
ADMU3100I: Reading configuration for server: serverl 
ADHU3200I: Server launched. Waiting for initialization status. 
ADMU3000I: Server serverl open for e-business; process id is 2488 


fC: SWe bS phe re\A ppSc rver\b in >s tart server WebSpherc_Portal 


pnerexRpp 

|ADMU011bI: Tool infornation is being logged in file 


C:\WebSphere\AppServerSlogs\WebSphere_Portal\startServer.log 
ADF1U3100I : Reading configuration for server: WebSphcre_Portal 
ADHU3200I: Server launched. Waiting for initialization status. 

ADMJ3000I: Server WebSphere__Portal open for e-business; process id is 2412 


C:\WebSphere\AppServer\bin>startserver LotusWorkplace.Server 


ADMU 0116 I: 


ADMU3100I 

ADMU3200I 

ADMU3000I 


Tool infornation is being logged in file 

'vLo 


C:\WebSphere\AppServer\logs\LotusWorkplace_Server\startServer.log 
Reading configuration for server: LotusWorkplace.Server 
Server launched. Waiting for initialization status. 

Server LotusWorkplace.Server open for e-business; process id is 2288 


K): NWe bS phe re\A ppSe rve rsb in > 


° Go to Windows - Services and stop and start the IBM HTTP server, as 
shown in the figure below: 

Note: This is to allow the Updated Web Configuration to take effect on 
the server. 
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° Enter the following URL in your browser and log in as wpsadmin to 
test and verify the completion on your IBM Lotus Workplace 1.1 
installation. 

http://lwpl1.techpreview.ibm.com/lwp/myworkplace 


Then log in as user: wpsadmin, password: wpsadmin 
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Section 4. Wrap up 


Summary 

At the end, you should have a functional install of the IBM Lotus Workplace 
version 1.1 environment. This proof-of-concept setup can help you understand 
the functionality and the look and feel of this product. As a developer, you get to 
play with the different components of the IBM Lotus Workplace VI .1. The APIs 
to the different components of this product are expected to be available with the 
next release. 


Resources 

Here are some resources you may find helpful: 

° For an overview of Lotus Workplace, see " What is IBM Lotus Workplace? 

(http://www-10.lotus.com/ldd/today.nsf/lookup/LWP11)". 

° See the Lotus Workplace 1.1 documentation. 

° Download the lwp_techpreview.ldif used in this tutorial. This LDIF file 
contains all the users to be imported in your LDAP. 

° Download the Iwpprops.properties.techpreview used in this tutorial. The 
configured version of the Iwpprops.properties file. 


Feedback 


Colophon 

This tutorial was written entirely in XML, using the developerWorks Toot-O-Matic tutorial 
generator. The open source Toot-O-Matic tool is an XSLT stylesheet and several XSLT 
extension functions that convert an XML file into a number of HTML pages, a zip file, JPEG 
heading graphics, and two PDF files. Our ability to generate multiple text and binary formats 
from a single source file illustrates the power and flexibility of XML. (It also saves our 
production team a great deal of time and effort.) 

For more information about the Toot-O-Matic, visit 
www- 106 .ibm.com/developerworks/xml/library/x-toot/ . 
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